Skip to content

Improve Quota Statement#10506

Merged
winterhazel merged 13 commits into
apache:mainfrom
scclouds:improve-quota-statement
Apr 30, 2026
Merged

Improve Quota Statement#10506
winterhazel merged 13 commits into
apache:mainfrom
scclouds:improve-quota-statement

Conversation

@julien-vaz
Copy link
Copy Markdown
Contributor

Description

In the current version, the quotaStatement API is returning the internal ID for account and domain, which is not useful for users, since all APIs use/return the UUID. Also, when the usage_type parameter is informed, the API shows dummy records.

To address those problems:

  • the API was modified so it returns the resources' UUID;
  • the dummy records bug was fixed;
  • a new parameter showresources was added to display more information to the user about each usage type;
  • a new quotaStatementDetails API was created to list more details about each usage type;

Types of changes

  • Breaking change (fix or feature that would cause existing functionality to change)
  • New feature (non-breaking change which adds functionality)
  • Bug fix (non-breaking change which fixes an issue)
  • Enhancement (improves an existing feature and functionality)
  • Cleanup (Code refactoring and cleanup, that may add test cases)
  • build/CI
  • test (unit or integration test code)

Feature/Enhancement Scale or Bug Severity

Feature/Enhancement Scale

  • Major
  • Minor

How Has This Been Tested?

On CloudMonkey the quotaStatement API was called and:

  • the resources' UUID was returned instead of the internal ID;
  • when specified a usage_type no dummy records were showed;
  • the showresources parameter is properly working;

The quotaStatementDetails API was called successfully as well.

@julien-vaz
Copy link
Copy Markdown
Contributor Author

@blueorangutan package

@blueorangutan
Copy link
Copy Markdown

@julien-vaz a [SL] Jenkins job has been kicked to build packages. It will be bundled with KVM, XenServer and VMware SystemVM templates. I'll keep you posted as I make progress.

@blueorangutan
Copy link
Copy Markdown

Packaging result [SF]: ✖️ el8 ✖️ el9 ✖️ debian ✖️ suse15. SL-JID 12669

@codecov
Copy link
Copy Markdown

codecov Bot commented Mar 5, 2025

Codecov Report

❌ Patch coverage is 21.37592% with 320 lines in your changes missing coverage. Please review.
✅ Project coverage is 18.02%. Comparing base (3166e64) to head (1f39686).
⚠️ Report is 9 commits behind head on main.

Files with missing lines Patch % Lines
...udstack/api/response/QuotaResponseBuilderImpl.java 31.61% 105 Missing and 1 partial ⚠️
...g/apache/cloudstack/quota/vo/QuotaUsageJoinVO.java 27.90% 62 Missing ⚠️
...he/cloudstack/quota/dao/QuotaUsageJoinDaoImpl.java 0.00% 37 Missing ⚠️
...apache/cloudstack/quota/vo/QuotaTariffUsageVO.java 0.00% 31 Missing ⚠️
...ache/cloudstack/quota/vo/QuotaUsageResourceVO.java 0.00% 27 Missing ⚠️
...ache/cloudstack/api/command/QuotaStatementCmd.java 15.78% 16 Missing ⚠️
.../cloudstack/quota/dao/QuotaTariffUsageDaoImpl.java 0.00% 15 Missing ⚠️
...i/response/QuotaStatementItemResourceResponse.java 0.00% 13 Missing ⚠️
...loudstack/api/response/QuotaStatementResponse.java 36.36% 7 Missing ⚠️
...c/main/java/com/cloud/utils/db/SearchCriteria.java 0.00% 4 Missing ⚠️
... and 1 more
Additional details and impacted files
@@             Coverage Diff              @@
##               main   #10506      +/-   ##
============================================
+ Coverage     18.01%   18.02%   +0.01%     
- Complexity    16607    16628      +21     
============================================
  Files          6029     6035       +6     
  Lines        542160   542444     +284     
  Branches      66451    66473      +22     
============================================
+ Hits          97682    97790     +108     
- Misses       433461   433642     +181     
+ Partials      11017    11012       -5     
Flag Coverage Δ
uitests 3.52% <ø> (ø)
unittests 19.18% <21.37%> (+0.01%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@winterhazel winterhazel self-requested a review March 6, 2025 13:06
@julien-vaz
Copy link
Copy Markdown
Contributor Author

@blueorangutan package

@blueorangutan
Copy link
Copy Markdown

@julien-vaz a [SL] Jenkins job has been kicked to build packages. It will be bundled with KVM, XenServer and VMware SystemVM templates. I'll keep you posted as I make progress.

@blueorangutan
Copy link
Copy Markdown

Packaging result [SF]: ✖️ el8 ✖️ el9 ✖️ debian ✖️ suse15. SL-JID 12689

@julien-vaz
Copy link
Copy Markdown
Contributor Author

I've just successfully builded the packages locally with -Dnoredist. Therefore, I'm requesting the package building again

@julien-vaz
Copy link
Copy Markdown
Contributor Author

@blueorangutan package

@blueorangutan
Copy link
Copy Markdown

@julien-vaz a [SL] Jenkins job has been kicked to build packages. It will be bundled with KVM, XenServer and VMware SystemVM templates. I'll keep you posted as I make progress.

@blueorangutan
Copy link
Copy Markdown

Packaging result [SF]: ✔️ el8 ✔️ el9 ✔️ debian ✔️ suse15. SL-JID 12742

Copy link
Copy Markdown
Contributor

@lucas-a-martins lucas-a-martins left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CLGTM

Copy link
Copy Markdown
Contributor

@DaanHoogland DaanHoogland left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

clgtm

@bernardodemarco bernardodemarco self-requested a review June 4, 2025 17:38
@sureshanaparti
Copy link
Copy Markdown
Contributor

@blueorangutan package

@blueorangutan
Copy link
Copy Markdown

@sureshanaparti a [SL] Jenkins job has been kicked to build packages. It will be bundled with KVM, XenServer and VMware SystemVM templates. I'll keep you posted as I make progress.

@blueorangutan
Copy link
Copy Markdown

@winterhazel a [SL] Jenkins job has been kicked to build packages. It will be bundled with no SystemVM templates. I'll keep you posted as I make progress.

@blueorangutan
Copy link
Copy Markdown

Packaging result [SF]: ✔️ el8 ✔️ el9 ✔️ el10 ✔️ debian ✔️ suse15. SL-JID 17410

@github-actions
Copy link
Copy Markdown

ghost commented Apr 13, 2026

This pull request has merge conflicts. Dear author, please fix the conflicts and sync your branch with the base branch.

@DaanHoogland
Copy link
Copy Markdown
Contributor

@blueorangutan package

@blueorangutan
Copy link
Copy Markdown

@DaanHoogland a [SL] Jenkins job has been kicked to build packages. It will be bundled with no SystemVM templates. I'll keep you posted as I make progress.

@blueorangutan
Copy link
Copy Markdown

Packaging result [SF]: ✔️ el8 ✔️ el9 ✔️ el10 ✔️ debian ✔️ suse15. SL-JID 17568

@winterhazel
Copy link
Copy Markdown
Member

@blueorangutan package

Copy link
Copy Markdown
Member

@winterhazel winterhazel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tested the API's parameters (account, accountid, domainid, enddate, projectid, showresources, startdate, type) for root admin, domain admin, and user accounts. In the tests, I validated that the API returned the expected response while performing correct permission checking. The same environment from #10505 (comment) was used.


Environment configuration

My environment had two domains: ROOT and d1.

MariaDB [cloud]> select uuid,name,path,parent from domain;
+--------------------------------------+------+------+--------+
| uuid                                 | name | path | parent |
+--------------------------------------+------+------+--------+
| de3f3dfb-f84b-11f0-8ace-32e0826870ba | ROOT | /    |   NULL |
| dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d | d1   | /d1/ |      1 |
+--------------------------------------+------+------+--------+

Each domain had a domain admin (dr for ROOT and d1 for d1) and a user account (ur for ROOT and u1 for d1). ROOT also had a project and the root admin.

MariaDB [cloud]> select uuid,account_name,domain_id,role_id from account;
+--------------------------------------+--------------------------+-----------+---------+
| uuid                                 | account_name             | domain_id | role_id |
+--------------------------------------+--------------------------+-----------+---------+
| f684aae8-f84b-11f0-8ace-32e0826870ba | system                   |         1 |       1 |
| f684da1a-f84b-11f0-8ace-32e0826870ba | admin                    |         1 |       1 |
| 17dfdcce-fd02-46d0-85ae-7de91fda634c | baremetal-system-account |         1 |       4 |
| aaba75a0-a575-41be-80e1-dbea14c10e51 | dr                       |         1 |       3 |
| feaffae2-7ba4-45dc-b46f-20ae86192685 | d1                       |         2 |       3 |
| 2f49212d-d6d5-437b-800d-a7bb4a8def4b | u1                       |         2 |       4 |
| b029e8b8-e539-4d1a-906d-3d4f2fb36b82 | ur                       |         1 |       4 |
| b14100c6-d9f6-450e-87a2-0833bb45e5f8 | PrjAcct-aa-1             |         1 |    NULL |
+--------------------------------------+--------------------------+-----------+---------+

Test 1 (user accounts)

  • startdate and enddate only: returns only the user account's own statement.

     (u1) 🐱 > quota statement startdate=2025-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.1714893,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 23.43302496,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2025-03-01T00:00:00-0300",
         "totalquota": 24.60451426
       }
     }
  • account: allows generating their own statement, but not the statement of other accounts.

     (u1) 🐱 > quota statement account=u1 domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.1714893,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 23.43302496,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 24.60451426
       }
     }
    
     (u1) 🐱 > quota statement account=d1 domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
     🙈 Error: (HTTP 531, error code 4365) Caller does not have permission to operate with provided resource.
  • accountid: allows generating their own statement, but not the statement of other accounts.

     (u1) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.1714893,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 23.43302496,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 24.60451426
       }
     }
    
     (u1) 🐱 > quota statement accountid=aaba75a0-a575-41be-80e1-dbea14c10e51 startdate=2026-03-01 enddate=2027-03-02
     🙈 Error: (HTTP 531, error code 4365) Caller does not have permission to operate with provided resource.
  • domainid: only generates their own statement. Returns an error when specifying a domain they do not belong to.

     (u1) 🐱 > quota statement domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.1714893,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 23.43302496,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 24.60451426
       }
     }
    
     (u1) 🐱 > quota statement domainid=de3f3dfb-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
     🙈 Error: (HTTP 531, error code 4365) Account Account [{"accountName":"u1","id":6,"uuid":"2f49212d-d6d5-437b-800d-a7bb4a8def4b"}] does not have permission to operate within domain id=de3f3dfb-f84b-11f0-8ace-32e0826870ba
  • showresources: lists the resources of each quota type in the period when set to true.

     (u1) 🐱 > quota statement startdate=2026-03-01 enddate=2027-03-02 showresources=true
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "VM-91c1a276-e8a9-4fe9-bf93-905d84428b9a",
     	    "quotaconsumed": 0,
     	    "removed": false,
     	    "resourceid": "91c1a276-e8a9-4fe9-bf93-905d84428b9a"
     	  }
     	],
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.1714893,
     	"resources": [
     	  {
     	    "displayname": "VM-91c1a276-e8a9-4fe9-bf93-905d84428b9a",
     	    "quotaconsumed": 1.1714893,
     	    "removed": false,
     	    "resourceid": "91c1a276-e8a9-4fe9-bf93-905d84428b9a"
     	  }
     	],
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"resources": [],
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"resources": [],
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"resources": [],
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "ROOT-9",
     	    "quotaconsumed": 0,
     	    "removed": false,
     	    "resourceid": "d32f9ae3-c088-4f14-a15e-d2dcb0e53e98"
     	  }
     	],
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"resources": [],
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"resources": [],
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"resources": [],
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"resources": [],
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"resources": [],
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"resources": [],
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "DefaultL2NetworkOffering",
     	    "quotaconsumed": 0,
     	    "removed": false,
     	    "resourceid": "d5090e0b-a8ec-4435-973f-8af355faaa25"
     	  }
     	],
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"resources": [],
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"resources": [],
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"resources": [],
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"resources": [],
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"resources": [],
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"resources": [],
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"resources": [],
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"resources": [],
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"resources": [],
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"resources": [],
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 23.43302496,
     	"resources": [
     	  {
     	    "displayname": "<untraceable>",
     	    "quotaconsumed": 23.43302496,
     	    "removed": false
     	  }
     	],
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"resources": [],
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 24.60451426
       }
     }
    
     (u1) 🐱 > quota statement startdate=2026-03-01 enddate=2027-03-02 showresources=false
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.1714893,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 23.43302496,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 24.60451426
       }
     }
  • type: filters the statement to only include usage records for the specified usage type.

     (u1) 🐱 > quota statement startdate=2026-03-01 enddate=2027-03-02 type=1
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }
    
     (u1) 🐱 > quota statement startdate=2026-03-01 enddate=2027-03-02 type=1 showresources=true
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "VM-91c1a276-e8a9-4fe9-bf93-905d84428b9a",
     	    "quotaconsumed": 0,
     	    "removed": false,
     	    "resourceid": "91c1a276-e8a9-4fe9-bf93-905d84428b9a"
     	  }
     	],
     	"type": 1,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }
  • projectid: user accounts can only obtain statements for projects they belong to.

     (u1) 🐱 > quota statement projectid=c1ce41c4-7b01-4386-8264-479db5ace0bc startdate=2026-03-01 enddate=2027-03-02
     🙈 Error: (HTTP 432, error code 9999) The API [quotaStatement] does not exist or is not available for this account/user in project [c1ce41c4-7b01-4386-8264-479db5ace0bc].
    
     (ur) 🐱 > quota statement projectid=c1ce41c4-7b01-4386-8264-479db5ace0bc startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "ur",
         "accountid": "b029e8b8-e539-4d1a-906d-3d4f2fb36b82",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 0,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 0,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }

Test 2 (domain admins)

  • startdate and enddate only: returns only their own statement.

     (d1) 🐱 > quota statement startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "d1",
         "accountid": "feaffae2-7ba4-45dc-b46f-20ae86192685",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 0.32591051,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 6.51882704,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 6.84473755
       }
     }
  • account: allows generating statements for accounts belonging to their domain, but not for accounts from other domains.

     (d1) 🐱 > quota statement account=u1 domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.93128489,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 45.14953752,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 47.08082241
       }
     }
    
     (d1) 🐱 > quota statement account=d1 domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "d1",
         "accountid": "feaffae2-7ba4-45dc-b46f-20ae86192685",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 0.32591051,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 6.51882704,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 6.84473755
       }
     }
    
     (d1) 🐱 > quota statement account=admin domainid=de3f3dfb-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
     🙈 Error: (HTTP 531, error code 4365) Caller does not have permission to operate with provided resource
    
  • accountid: allows generating statements for accounts belonging to their domain, but not for accounts from other domains.

     (d1) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.93128489,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 45.14953752,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 47.08082241
       }
     }
    
     (d1) 🐱 > quota statement accountid=feaffae2-7ba4-45dc-b46f-20ae86192685 startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "d1",
         "accountid": "feaffae2-7ba4-45dc-b46f-20ae86192685",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 0.32591051,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 6.51882704,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 6.84473755
       }
     }
    
     (d1) 🐱 > quota statement accountid=f684da1a-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
     🙈 Error: (HTTP 531, error code 4365) Caller does not have permission to operate with provided resource.
  • domainid: allows generating statements for all accounts in their domain, but returns an error for domains outside their scope.

     (d1) 🐱 > quota statement domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 2.2571954,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 51.66836456,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 53.92555996
       }
     }
    
     (d1) 🐱 > quota statement domainid=de3f3dfb-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
     🙈 Error: (HTTP 531, error code 4365) Account Account [{"accountName":"d1","id":5,"uuid":"feaffae2-7ba4-45dc-b46f-20ae86192685"}] does not have permission to operate within domain id=de3f3dfb-f84b-11f0-8ace-32e0826870ba
  • showresources: lists the resources of each quota type in the period when set to true.

     (d1) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02 showresources=true
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "VM-91c1a276-e8a9-4fe9-bf93-905d84428b9a",
     	    "quotaconsumed": 0,
     	    "removed": true,
     	    "resourceid": "91c1a276-e8a9-4fe9-bf93-905d84428b9a"
     	  }
     	],
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.93128489,
     	"resources": [
     	  {
     	    "displayname": "VM-91c1a276-e8a9-4fe9-bf93-905d84428b9a",
     	    "quotaconsumed": 1.93128489,
     	    "removed": true,
     	    "resourceid": "91c1a276-e8a9-4fe9-bf93-905d84428b9a"
     	  }
     	],
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"resources": [],
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"resources": [],
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"resources": [],
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "ROOT-9",
     	    "quotaconsumed": 0,
     	    "removed": true,
     	    "resourceid": "d32f9ae3-c088-4f14-a15e-d2dcb0e53e98"
     	  }
     	],
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"resources": [],
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"resources": [],
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"resources": [],
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"resources": [],
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"resources": [],
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"resources": [],
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "DefaultL2NetworkOffering",
     	    "quotaconsumed": 0,
     	    "removed": false,
     	    "resourceid": "d5090e0b-a8ec-4435-973f-8af355faaa25"
     	  }
     	],
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"resources": [],
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"resources": [],
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"resources": [],
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"resources": [],
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"resources": [],
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"resources": [],
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"resources": [],
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"resources": [],
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"resources": [],
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"resources": [],
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 45.14953752,
     	"resources": [
     	  {
     	    "displayname": "<untraceable>",
     	    "quotaconsumed": 45.14953752,
     	    "removed": false
     	  }
     	],
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"resources": [],
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 47.08082241
       }
     }
    
     (d1) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02 showresources=false
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.93128489,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 45.14953752,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 47.08082241
       }
     }
  • type: filters the statement to only include usage records for the specified usage type.

     (d1) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02 type=1
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }
    
     (d1) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02 type=1 showresources=true
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "VM-91c1a276-e8a9-4fe9-bf93-905d84428b9a",
     	    "quotaconsumed": 0,
     	    "removed": true,
     	    "resourceid": "91c1a276-e8a9-4fe9-bf93-905d84428b9a"
     	  }
     	],
     	"type": 1,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }
  • projectid: allows generating statements for projects belonging to their domain, but returns an error for projects outside it.

     (d1) 🐱 > quota statement projectid=c1ce41c4-7b01-4386-8264-479db5ace0bc startdate=2026-03-01 enddate=2027-03-02
     🙈 Error: (HTTP 531, error code 4365) Account Account [{"accountName":"d1","id":5,"uuid":"feaffae2-7ba4-45dc-b46f-20ae86192685"}] does not have permission to operate within domain id=de3f3dfb-f84b-11f0-8ace-32e0826870ba
    
     (dr) 🐱 > quota statement projectid=c1ce41c4-7b01-4386-8264-479db5ace0bc startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "PrjAcct-aa-1",
         "accountid": "b14100c6-d9f6-450e-87a2-0833bb45e5f8",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 0,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 0,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }

Test 3 (root admins)

  • startdate and enddate only: returns only their own statement.

     (admin) 🐱 > quota statement startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "admin",
         "accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 87.68817432,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 0,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 87.68817432
       }
     }
  • account: allows generating statements for all accounts.

     (admin) 🐱 > quota statement account=dr domainid=de3f3dfb-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "dr",
         "accountid": "aaba75a0-a575-41be-80e1-dbea14c10e51",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 0,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 0,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }
    
     (admin) 🐱 > quota statement account=u1 domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.93128489,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 45.14953752,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 47.08082241
       }
     }
  • accountid: allows generating statements for all accounts.

     (admin) 🐱 > quota statement accountid=f684da1a-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "admin",
         "accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 87.68817432,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 0,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 87.68817432
       }
     }
    
     (admin) 🐱 > quota statement accountid=b029e8b8-e539-4d1a-906d-3d4f2fb36b82 startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "ur",
         "accountid": "b029e8b8-e539-4d1a-906d-3d4f2fb36b82",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 0,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 0,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }
    
     (admin) 🐱 > quota statement accountid=feaffae2-7ba4-45dc-b46f-20ae86192685 startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "d1",
         "accountid": "feaffae2-7ba4-45dc-b46f-20ae86192685",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 0.32591051,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 6.51882704,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 6.84473755
       }
     }
    
     (admin) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.93128489,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 45.14953752,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 47.08082241
       }
     }
  • domainid: allows generating statements for all domains.

     (admin) 🐱 > quota statement domainid=de3f3dfb-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 87.68817432,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 0,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 87.68817432
       }
     }
    
     (admin) 🐱 > quota statement domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 2.2571954,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 51.66836456,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 53.92555996
       }
     }
  • showresources: lists the resources of each quota type in the period when set to true.

     (admin) 🐱 > quota statement accountid=f684da1a-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02 showresources=true
     {
       "statement": {
         "account": "admin",
         "accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "VM-3fd7e901-8d9a-4b22-bc4a-df4145088535",
     	    "quotaconsumed": 0,
     	    "removed": false,
     	    "resourceid": "3fd7e901-8d9a-4b22-bc4a-df4145088535"
     	  }
     	],
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 87.68817432,
     	"resources": [
     	  {
     	    "displayname": "VM-3fd7e901-8d9a-4b22-bc4a-df4145088535",
     	    "quotaconsumed": 87.68817432,
     	    "removed": false,
     	    "resourceid": "3fd7e901-8d9a-4b22-bc4a-df4145088535"
     	  }
     	],
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"resources": [],
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"resources": [],
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"resources": [],
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"resources": [],
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"resources": [],
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"resources": [],
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"resources": [],
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"resources": [],
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"resources": [],
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"resources": [],
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "DefaultSharedNetworkOffering",
     	    "quotaconsumed": 0,
     	    "removed": false,
     	    "resourceid": "b7f878a4-b72b-4ae6-a496-2f8ccd5b98e4"
     	  }
     	],
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"resources": [],
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"resources": [],
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"resources": [],
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"resources": [],
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"resources": [],
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"resources": [],
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"resources": [],
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"resources": [],
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"resources": [],
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"resources": [],
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 0,
     	"resources": [],
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"resources": [],
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 87.68817432
       }
     }
    
     (admin) 🐱 > quota statement accountid=f684da1a-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02 showresources=false
     {
       "statement": {
         "account": "admin",
         "accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 87.68817432,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 0,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 87.68817432
       }
     }
  • type: filters the statement to only include usage records for the specified usage type.

     (admin) 🐱 > quota statement accountid=f684da1a-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02 type=1
     {
       "statement": {
         "account": "admin",
         "accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }
    
     (admin) 🐱 > quota statement accountid=f684da1a-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02 type=1 showresources=true
     {
       "statement": {
         "account": "admin",
         "accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "VM-3fd7e901-8d9a-4b22-bc4a-df4145088535",
     	    "quotaconsumed": 0,
     	    "removed": false,
     	    "resourceid": "3fd7e901-8d9a-4b22-bc4a-df4145088535"
     	  }
     	],
     	"type": 1,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }
  • projectid: allows generating statements for all projects in the environment.

     (admin) 🐱 > quota statement projectid=c1ce41c4-7b01-4386-8264-479db5ace0bc startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "PrjAcct-aa-1",
         "accountid": "b14100c6-d9f6-450e-87a2-0833bb45e5f8",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 0,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 0,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }
    
     (admin) 🐱 > quota statement projectid=3841cab4-e861-44a4-97e4-cb122ae9e7dd startdate=2026-03-01 enddate=2027-03-02 type=1
     {
       "statement": {
         "account": "PrjAcct-pd1-2",
         "accountid": "b8c5a156-193d-47b5-8dbc-c26e8a0a3ea3",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }

@winterhazel
Copy link
Copy Markdown
Member

@blueorangutan package

@blueorangutan
Copy link
Copy Markdown

@winterhazel a [SL] Jenkins job has been kicked to build packages. It will be bundled with no SystemVM templates. I'll keep you posted as I make progress.

Copy link
Copy Markdown
Member

@bernardodemarco bernardodemarco left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

code lgtm, did not test it

@blueorangutan
Copy link
Copy Markdown

Packaging result [SF]: ✔️ el8 ✔️ el9 ✔️ el10 ✔️ debian ✔️ suse15. SL-JID 17592

@winterhazel
Copy link
Copy Markdown
Member

@DaanHoogland @sureshanaparti can we run the CI here?

@sureshanaparti
Copy link
Copy Markdown
Contributor

@blueorangutan test

@blueorangutan
Copy link
Copy Markdown

@sureshanaparti a [SL] Trillian-Jenkins test job (ol8 mgmt + kvm-ol8) has been kicked to run smoke tests

@blueorangutan
Copy link
Copy Markdown

[SF] Trillian test result (tid-15943)
Environment: kvm-ol8 (x2), zone: Advanced Networking with Mgmt server ol8
Total time taken: 49927 seconds
Marvin logs: https://github.com/blueorangutan/acs-prs/releases/download/trillian/pr10506-t15943-kvm-ol8.zip
Smoke tests completed. 151 look OK, 0 have errors, 0 did not run
Only failed and skipped tests results shown below:

Test Result Time (s) Test File

@winterhazel
Copy link
Copy Markdown
Member

@shwstppr @nvazquez I have addressed the issues you pointed out. Do you still plan to review this PR, or can we merge it?

@DaanHoogland
Copy link
Copy Markdown
Contributor

@shwstppr @nvazquez I have addressed the issues you pointed out. Do you still plan to review this PR, or can we merge it?

let’s give them a few days @winterhazel , maybe till the weekend?

@shwstppr shwstppr self-requested a review April 28, 2026 14:37
@shwstppr
Copy link
Copy Markdown
Contributor

I've no further comment here. Earlier highlighted issue seems to have been addressed

Copy link
Copy Markdown
Contributor

@shwstppr shwstppr left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

code lgtm. My quota plugin knowledge is limited. Reported tests look good

@DaanHoogland
Copy link
Copy Markdown
Contributor

thanks for the followup @shwstppr . @winterhazel I see no serious comment by @nvazquez. He only asked about the same thing @shwstppr noticed, so I think we can merge.

@winterhazel
Copy link
Copy Markdown
Member

@shwstppr thanks for the review. I am proceeding with the merge for this one.

@winterhazel winterhazel merged commit a73cc9a into apache:main Apr 30, 2026
27 of 28 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.